home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1998 June / Macworld (1998-06).dmg / Shareware World / Comms & Internet / Email Checker / Email Checker ReadMe / Email Checker ReadMe.rsrc / TEXT_128.txt < prev    next >
Text File  |  1998-03-18  |  16KB  |  505 lines

  1.  
  2. Email Checker ‚Ñ¢¬†
  3. by Rich Love
  4.  
  5. Version 1.0
  6. Copyright 1998
  7. Carnation Software
  8. http://www.carnationsoftware.com
  9. All Rights Reserved
  10.  
  11. What Does It Do?
  12.  
  13. Email Checker checks your email at specified time intervals using your email program.
  14. Email programs supported are:
  15.  
  16. Claris Emailer or Claris Emailer Lite
  17. Eudora Pro, Eudora or Eudora Lite
  18. Outlook Express
  19.  
  20. Features
  21.  
  22. ‚Ä¢    Will not interrupt your work by trying to dial the phone to get mail (unless you want it to).
  23.  
  24.         ‚Ä¢ If you are not online with a PPP Connection, Email Checker will not attempt to check mail.
  25.  
  26.         ‚Ä¢ Checks mail as soon as a PPP Connection is established and then at the specified time interval.
  27.  
  28. ‚Ä¢    If you choose to automatically connect when checking for mail, PPP will dial and connect in the background so you can continue working.
  29.  
  30. ‚Ä¢ Easy to set up. Uses your existing email accounts from your email program.
  31.  
  32. ‚Ä¢ Status window has a progress bar showing how much time is left until mail is checked again.
  33.  
  34. Also shows the PPP connection status (open or closed), baud rate and minutes connected.
  35.  
  36. What Makes This Program So Useful?
  37.  
  38. ‚Ä¢ It does not interfere with your normal computing activities. Just set it and forget it. Email Checker will automatically retrieve your email as soon as it sees a PPP connection and then at the specified time intervals. When the PPP connection is broken (you hang up or the phone line causes a disconnect), Email Checker will not attempt to get the mail until the connection is restored.
  39.  
  40. ‚Ä¢ The first time you run Email Checker, it installs an alias of itself in the System Startup Folder so it will always be running when you restart your Mac.
  41.  
  42. ‚Ä¢ Works with the three most popular email programs (Claris Emailer, Eudora and Outlook Express).
  43.  
  44. ‚Ä¢ Status window gives you valuable information about your connection (PPP connection status [open or closed], baud rate and minutes connected.)
  45.  
  46. What You Need?
  47.  
  48. Any Macintosh.
  49. 1100K of free memory.
  50. System 7 or later
  51. AppleScript 1.1 or later
  52. Open Transport/PPP 1.0 or later
  53.  
  54. One of the following Email Programs:
  55. Claris Emailer or Claris Emailer Lite
  56. Eudora Pro, Eudora or Eudora Lite
  57. Outlook Express
  58.  
  59.  
  60. Welcome to Email Checker
  61. Before you do anything, make sure that your email program is working and you are able to receive mail. Email checker will not be able to check your mail until you do this first. Also make sure that you are using OpenTransport/PPP 1.0 or later (you should have a folder called Open Transport/PPP on your hard drive. Don't confuse the 1.0 version number with older separate versions of PPP and Open Transport).
  62. Read the document called "About Open Transport/PPP" for help with that product.
  63.  
  64. OpenTransport/PPP is available from Apple at:
  65. http://swupdates.info.apple.com
  66. and is included with OS 8
  67.  
  68. You also need AppleScript 1.1 or later.
  69.  
  70. Carnation Software will not provide free tech support for these NON-Email Checker issues.
  71.  
  72.  
  73. Instructions:
  74.  
  75. Running Email Checker for the first time:
  76.  
  77. ‚Ä¢ Where is Claris Emailer?
  78.  
  79. The first time you run Email Checker, it will ask you where your email programs are.
  80. For instance it might say, "Where is Claris Emailer".
  81. If you have Claris Emailer then navigate to that program and select it.
  82. If you do not have Claris Emailer, then select the Claris Emailer Placeholder file.
  83.  
  84. Do NOT select a placeholder file if you have Claris Emailer installed on your Mac.
  85.  
  86. Note: If you install Email Checker and do not have Claris Emailer installed and select the Claris Emailer Placeholder file:
  87.  
  88. Then at a later time you install Claris Emailer, you will need to drag the Claris Emailer Placeholder file into the trash and empty the trash (or move it to another disk). Then when you run Email Checker again, it will ask for the placeholder file and you can select the real Claris Emailer Program instead. The same rules apply for Eudora and Outlook Express. This is a bug/feature of AppleScript.
  89.  
  90. ‚Ä¢ Account Setup and Enabling Email Programs
  91.  
  92. When Email Checker detects your email program, it will ask you if you want to enable it.
  93. Answer yes to the email program that you want to check mail from (you can check mail from more than one email program if you wish).
  94.  
  95. If you enabled Claris Emailer or Outlook Express, Email Checker will ask you to specify which accounts you want to check mail for. You can check mail for up to 3 accounts per email program.
  96.  
  97. Copy the account(s) that you want from the Accounts Available list into the First Account Name, Second Account Name etc.
  98.  
  99. Eudora Lite and Claris Emailer Lite presently support only one account.
  100.  
  101. Eudora Pro supports multiple accounts called personalities. Email Checker will check mail for all personalities that have been enabled in Eudora Pro. 
  102.  
  103.  
  104.  
  105.  
  106. Email Checker Menus:
  107.  
  108. Email Accounts Menu
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117. Get Email Now
  118.  
  119. Gets email from all enabled email programs.
  120.  
  121. Enable Claris Emailer
  122. Enable Eudora
  123. Enable Outlook Express
  124.  
  125. Enables email checking for the checked programs. If Email Checker cannot find the email program on your computer, it will not let you select it.
  126.  
  127. Sidebar Note:
  128.  
  129. If you have Claris Emailer, you can use an AppleScript provided with Email Checker that will bring Claris Emailer to the front when new mail arrives. Look in the folder called "Activate Email Script" and read the "Activate Emailer ReadMe" file. 
  130.  
  131. Outlook Express Accounts
  132. Works the same way as Claris Emailer Accounts.
  133.  
  134. Claris Emailer Accounts
  135.  
  136. Email Checker automatically asks Claris Emailer for a list of accounts available.
  137. All you have to do is copy (or drag and drop) the account from the Accounts Available list to the account field below. It does not really matter which account field you copy the account to.
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176. Claris Emailer Lite Accounts
  177.  
  178. If you try to select Claris Emailer Accounts using Claris Emailer Lite, you will get the following message and Email Checker will use Internet as the account name. This actually works even though your account name in Emailer Lite is not necessarily Internet.
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193. Eudora Accounts
  194.  
  195. Eudora Lite presently only supports one account.
  196.  
  197. Eudora Pro supports multiple accounts called personalities. Email Checker will check mail for all personalities that have been enabled in Eudora Pro. 
  198.  
  199.  
  200. PPP Connection Menu
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208. Connect Now
  209.  
  210. If you are not currently connected, Email Checker will tell PPP to dial and connect to your service provider. Mail will not be checked until the next scheduled time interval (Email Checking Frequency).
  211.  
  212. Disconnect Now
  213.  
  214. Will tell PPP to disconnect and hang up the phone connection.
  215.  
  216.  
  217. Connect When Checking For Mail
  218.  
  219. Will tell PPP to connect (if not already connected) when checking for mail.
  220. This is normally not desirable since it has to go through the dialing process and make the connection before mail is checked.
  221.  
  222. Usually you will just want to check for mail when you are already online.
  223. Therefore, the default condition for this menu item is unchecked.
  224.  
  225.  
  226. Options Menu
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238. Show Status Window
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267. The status window shows information about the connection and how much time remains before email is checked again. Several areas on this window respond to mouse clicks.
  268.  
  269. ¬†Notice the latch icons 
  270.  
  271.  
  272. Mouse Clicks:
  273.  
  274. 1. The latch icon at the lower left opens the window larger and displays information about the window. 
  275.  
  276. 2. The latch icon at the lower right will make the "Minutes Connected" display or not.
  277.  
  278. 3. The Email Checker icon to the right of the progress bar will take you to the "About Email Checker" window where you can click to go to the Carnation Software web page or send email to us.
  279.  
  280. 4. The "Minutes left before mail is checked" text or number box will let you change the email checking frequency when clicked.
  281.  
  282.  
  283. Email Checking Frequency
  284.  
  285. This is the time interval for checking email. The default is 10 minutes but you can make it any number of minutes except zero.
  286.  
  287.  
  288. Check Mail When Email Checker Starts Up
  289.  
  290. When this item has a checkmark, it will cause Email Checker to check for email immediately when you first run the program.  Email will only be retrieved if the PPP connection is open (unless Connect When Checking for Mail is checked under the PPP Connection menu).
  291.  
  292. Launch Email Checker When Mac Starts Up
  293.  
  294. When this item has a checkmark, it will cause Email Checker to start up each time your Mac is re-started. This is the normal mode of operation. It places an alias of Email Checker in the Startup Items Folder inside of the System Folder. Unchecking this item removes the alias.
  295.  
  296.  
  297. Registration
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319. Email Checker will run for a 30-day evaluation period. It will then expire unless you have paid the $25.00 registration fee. You will not be able to download another demo and use it if the first demo has expired.
  320.  
  321. You can register online at the Carnation Software web site
  322. http://www.carnationsoftware.com
  323. Just click on the Online Registration button and it will automatically open up your web browser and connect to our web site.
  324.  
  325. After you fill in the registration form online, a registration number will be emailed to you.
  326. Click on the Enter Registration Number button and enter that number.
  327.  
  328. You will not need to re-register Email Checker when you upgrade to new versions of the program.
  329.  
  330.  
  331.  
  332. Connect Automatically When Starting TCP/IP applications
  333. (This is a PPP Control Panel Option)
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355. One of the advantages of using Email Checker is that you can set  the option in your PPP control panel to connect automatically when any TCP/IP application starts up. For instance, if you are not online and are composing a letter in your email program, when you click on Send, PPP will automatically dial and connect to the Internet and send mail.
  356.  
  357. When checking for mail, Email Checker will not send a check mail command to your email program unless you are online (PPP does not try to dial). Usually this is the way you will want it to work. If you want PPP to dial automatically when checking for mail then set the option in Email Checker under the PPP Connections Menu called, "Connect When Checking for Mail"
  358.  
  359.  
  360.  
  361.  
  362. Shareware - Pay Your Fair Share
  363.  
  364. Just think of it this way - for only $25.00 you are getting a very useful program to automate your email checking. So, please take a few moments to register.
  365. You will receive free tech support and upgrades for version 1.
  366.  
  367. Please register one Email Checker program for each Macintosh: 
  368. $25.00 per user; the price is $10.00 per user for quantities of 10 or more. We take credit cards (VISA, MasterCard, AMEX) or checks.
  369.  
  370. 4 Ways to Register:
  371.  
  372. 1. Use your credit card and register online.
  373. Select "Registration..." from the Options Menu and click on "Online Registration"
  374. The address is:
  375. <http://www.carnationsoftware.com/carnation/EmailChecker.html>
  376.  
  377. 2. Send registration info and check or credit card information to:
  378. Rich Love
  379. Carnation software
  380. PO Box 608
  381. Carnation, WA  98014
  382.  
  383. You can use the registration form in the file called "Register Email Checker".
  384.  
  385. 3. Fax registration and credit card information to:
  386. Carnation Software
  387. Fax (425) 333-4902
  388.  
  389. 4. Call Carnation Software:
  390. Phone (425) 333-4288
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409. Technical Support and Troubleshooting
  410.  
  411. Help is available from Carnation Software for Email Checker problems, questions and bug reports. Please do not contact us with questions about your Email Program.
  412. You can send email to support@carnationsoftware.com
  413.  
  414. Email Checker just sends AppleScript commands to your email program.
  415. If your email program does not respond properly, you need to check the settings in your email program.
  416. Email Checker uses the account names you have set up in Claris Emailer and Outlook Express (Eudora Lite only supports one account so Email Checker does not have to check for an account name). A future version of Email Checker will support more accounts in Eudora
  417. You need to set up your email accounts properly and get them working from within your email program before attempting to use Email Checker.
  418.  
  419. ‚Ä¢ Where is Claris Emailer Lite?
  420.  
  421. If you have been using Email Checker with Claris Emailer Lite and you recently upgraded to the full version of Claris Emailer, and you have removed the Lite version from your hard drive, you will get the message, "Where is Claris Emailer Lite". Just navigate to your new full version of Claris Emailer and select it.
  422.  
  423. Note that if you have not removed the Lite version, Email Checker will continue to use Claris Emailer Lite instead of Claris Emailer.
  424.  
  425.  
  426. Open Transport/PPP
  427. Email Checker requires Open Transport/PPP 1.0 or later. It contains an AppleScript scripting addition, called "PPP Commands". It is placed in the "Scripting Additions" folder within the "Extensions" folder by the Open Transport/PPP installer. This file must be present for Email Checker to function. You will get an error when you try to run Email Checker (and it will quit) if you don't have this file installed or there is some other major problem with Open Transport/PPP. Please do NOT contact Carnation Softare regarding Open Transport/PPP installation problems (unless you want to pay $75 per hour in tech support fees :-)
  428.  
  429. OpenTransport/PPP is available from Apple at:
  430. http://swupdates.info.apple.com
  431. and is included with OS 8
  432.  
  433. AppleScript Error -1757 When Attempting To Run Email Checker
  434. This error is caused by AppleScript being installed improperly. It cannot find the Dialect file.
  435. This can happen if you install some new software and it inappropriately installs an older version of AppleScript. Note that Email Checker does not install any AppleScript files. This information is provided as a courtesy since it can be a real pain to figure out which files belong where.
  436.  
  437.  
  438. Location of AppleScript files.
  439.  
  440. (OS8 has two Scripting Addition folders. System 7 has just one)
  441.  
  442. OS8
  443.  
  444. You should have a Scripting Additions folder in your System Folder.
  445. You should also have a Dialects folder inside of the Scripting Additions folder. 
  446. If you are path-minded:
  447. Hard Drive:System Folder:Scripting Additions:Dialects
  448. Inside of the Dialects folder is your language dialect file (usually English Dialect).
  449. Email Checker needs this dialect file or it could get -1757 error.
  450.  
  451. You will also have a Scripting Additions folder inside of your System Extensions folder.
  452. That is where your PPP Commands scripting addition is. (Email Checker also needs this file)
  453. Hard Drive:System Folder:Extensions Folder:Scripting Additions:PPP Commands.
  454. If this file is not found by Email Checker it will warn you that PPP is not installed correctly.
  455.  
  456. In your Extensions folder you should have the AppleScript Extension (version 1.1.2 or later) and AppleScriptLib (version 1.2.2 or later).
  457.  
  458. System 7
  459.  
  460. Your Scripting Additions folder should be inside of your System Extensions folder.
  461. Hard Drive:System Folder:Extensions Folder:Scripting Additions
  462. The PPP Commands file should be there and the Dialects Folder also.
  463. Inside of the Dialects folder is your language dialect file (usually English Dialect).
  464. Email Checker needs this dialect file or it could get -1757 error.
  465.  
  466. In your Extensions folder you should have the AppleScript Extension (version 1.1)
  467.  
  468.  
  469. Legal Stuff
  470.  
  471. Email Checker is distributed as shareware.  This means that you may evaluate it free for 30 days, but if you continue using it beyond that time, you must pay a $25 (US) registration fee.
  472.  
  473. Email Checker may not be sold for profit without the express written permission of Rich Love and Carnation Software, Inc.
  474.  
  475. Carnation Software, Inc. cannot be held responsible for data lost or damaged email.  No warranty is given or implied. 
  476. Email Checker uses AppleScript commands to retrieve email. The AppleScript commands are supported and documented by their respective Email Program Companies. Carnation Software cannot be responsible for the AppleScript command functionality within those Email programs.
  477. Carnation Software, Inc. cannot be held responsible for damages resulting from the use of Email Checker.
  478.  
  479.  
  480. Email Checker is a trademark of Carnation Software.
  481. Claris Emailer, Eudora, Outlook Express and AppleScript are trademarks of there respective companies.
  482.  
  483.  
  484.  
  485. Credits
  486.  
  487. Email Checker was written by Rich Love using FaceSpan (a very nice AppleScript programming environment)
  488. http://www.carnation-software.com
  489.  
  490. Thanks to Hi-resolution software for the free use of the BetterInfoFor osax
  491. Their website is at http://www.hi-resolution.com/
  492.  
  493. FaceSpan information can be found at
  494. http://www.facespan.com
  495.  
  496.  
  497.  
  498.  
  499. Version History
  500.  
  501. 1.0 Released March 14, 1998
  502. ===========================
  503.  
  504.  
  505.